home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / mint / shells / bashsrc.zoo / features < prev    next >
Text File  |  1991-05-29  |  21KB  |  654 lines
  1. -*- text -*-
  2.  
  3. This isn't real documentation, but we have to tell people how this shell is
  4. different from others.
  5.  
  6. NEW STUFF SINCE LAST RELEASE:
  7.  
  8. history_control variable.
  9.  
  10. Set to a value of "ignorespace", it means don't enter lines which begin
  11. with a SPC on the history list.
  12.  
  13. Set to a value of "ignoredups", it means don't enter lines which match
  14. the last entered line.
  15.  
  16. Unset, or any other value than those above mean to save all lines read
  17. by the parser on the history list.
  18.  
  19. END OF NEW STUFF
  20.  
  21.  
  22. When and how bash executes login, rc, and logout files.
  23.  
  24. Login shells:
  25.   On login:
  26.     if /etc/profile exists, source it.
  27.  
  28.     if ~/.bash_profile exists, source it,
  29.       else if ~/.bash_login exists, source it,
  30.         else if ~/.profile exists, source it.
  31.   On logout:
  32.     if ~/.bash_logout exists, source it.
  33.  
  34. Non-login interactive shells:
  35.   On startup:
  36.     if ~/.bashrc exists, source it.
  37.  
  38. Non-interactive shells:
  39.   On startup:
  40.     if the environment variable "ENV" is non-null, source the file
  41.     mentioned there.
  42.  
  43. So, typically, your ~/.bash_profile file contains the line
  44.  
  45.     if [ -f ~/.bashrc ]; then source ~/.bashrc; fi
  46.  
  47. after (or before) any login specific initializations.
  48.  
  49. You can tell if a shell is interactive or not from within your ~/.bashrc
  50. file by examining $PS1; it is unset in non-interactive shells, and set in
  51. interactive shells.  Thus:
  52.  
  53.     if [ "$PS1" = "" ]; then
  54.        echo This shell is not interactive
  55.     else
  56.        echo This shell is interactive
  57.     fi
  58.  
  59. You can ask an interactive bash to not run your .bashrc file, with the
  60. -norc flag.  You can change the name of the .bashrc file to any other
  61. file with -rcfile FILENAME.  You can ask bash to not run your
  62. .bash_profile file with -noprofile.
  63.  
  64. alias: alias [ name [=value] ...]
  65.     Alias with no arguments prints the list of aliases in the form
  66.     name=value on standard output.  An alias is defined for each NAME
  67.     whose VALUE is given.  A trailing space in VALUE causes the next
  68.     word to be checked for alias substitution.  Alias returns true
  69.     unless a NAME is given for which no alias has been defined.
  70.  
  71. unalias: unalias [name ...]
  72.     Remove NAMEs from the list of defined aliases.
  73.  
  74. exec: exec [ [-] file [redirections]]
  75.     Exec FILE, replacing this shell with the specified program.
  76.     If FILE is not specified, the redirections take effect in this
  77.     shell.  If the first argument is `-', then place a dash in the
  78.     zeroith arg passed to FILE.  This is what login does.  If the file
  79.     cannot be exec'ed for some reason, the shell exits, unless the
  80.     shell variable "no_exit_on_failed_exec" exists.
  81.  
  82. help: help [pattern]
  83.     Display helpful information about builtin commands.  If
  84.     PATTERN is specified, gives detailed help on all commands
  85.     matching PATTERN, otherwise a list of the builtins is
  86.     printed.
  87.  
  88. enable: enable [-n name ...]
  89.     Enable and disable builtin shell commands.  This allows
  90.     you to use a disk command which has the same name as a shell
  91.     builtin.  If -n is used, the NAMEs become disabled.  Otherwise
  92.     NAMEs are enabled.  For example, to use /bin/test instead of the
  93.     shell builtin version, you would type `enable -n test'.
  94.  
  95. pushd: pushd [dir | +n]
  96.     Save the current directory on a list and then CD to DIR.
  97.     With no arguments, exchanges the top two directories.
  98.  
  99.     +n   Brings the Nth directory to the top of the list by rotating.
  100.  
  101.     dir  Makes the current working directory be the top of
  102.          the stack, and then cd's to DIR.
  103.  
  104.     You can see the saved directory list with the `dirs' command.
  105.  
  106. popd: popd [+n]
  107.     Pops the directory stack, and cd's to the new top directory.
  108.     The elements are numbered from 0 starting at the first directory
  109.     listed with `dirs'; i.e. `popd' is equivalent to `popd 0'.
  110.  
  111. history: history [n] [ [-w -r] [filename]]
  112.     Display the history list with line numbers.  Lines listed with
  113.     with a `*' have been modified.  Argument of N says to list only
  114.     the last N lines.  Argument `-w' means write out the current
  115.     history file.  `-r' means to read it instead.  If FILENAME is
  116.     given, then use that file, else if $HISTFILE has a value, use
  117.     that, else use ~/.bash_history.
  118.  
  119. ********************
  120. NEW Ulimit Implementation
  121.  
  122. ulimit: ulimit [-cdmstf [limit]]
  123.  Ulimit provides control over the resources available to processes
  124.         started by the shell, on systems that allow such control.  If an
  125.         option is given, it is interpreted as follows:
  126.  
  127.                 -c      the maximum size of core files created
  128.                 -d      the maximum size of a process's data segment
  129.                 -m      the maximum resident set size
  130.                 -s      the maximum stack size
  131.                 -t      the maximum amount of cpu time in milliseconds
  132.                 -f      the maximum size of files created by
  133.  
  134.         If limit is given, it is multiplied by a constant factor (a block
  135.         size, currently 512) and the result becomes the new value of the
  136.         specified resource.  If limit is not given, the current value of
  137.         the specified resource is printed.  If no option is given, then the
  138.         maximum allowable size of a file created by the shell or any of its
  139.         children is printed (equivalent to the -f option).
  140.  
  141. ********************
  142. Tilde expansion:
  143.  
  144. This shell does tilde  expansion:
  145.  
  146. ~ = $HOME
  147. ~/foo = $HOME/foo
  148. ~fred/foo = (fred's home directory)/foo
  149. ~+/foo = $PWD/foo
  150. ~-/foo = $OLDPWD/foo
  151.  
  152.  
  153.  
  154. We have functions.  You can say:
  155.  
  156.      foo () { ls $1 ; }
  157. or
  158.      function foo () { ls $1 ; }
  159.  
  160. Here is the comment next to the decode_prompt_string function.
  161.  
  162. /* Return a string which will be printed as a prompt.  The string
  163.    may contain special characters which are decoded as follows:
  164.    
  165.     \t    the time
  166.     \d    the date
  167.     \n    CRLF
  168.     \s    the name of the shell
  169.     \w    the current working directory
  170.     \u    your username
  171.     \h    the hostname
  172.     \#    the command number of this command
  173.     \!    the history number of this command
  174.     \<octal> character code in octal
  175.     \\    a backslash
  176. */
  177.  
  178. Here is the comment next to the check_mail function, which is called
  179. periodically.  See the documentation for ksh MAILCHECK MAILPATH, etc.
  180. We also have MAIL_WARNING, see below.
  181.  
  182. /* check_mail () is useful for more than just checking mail.  Since it has
  183.    the paranoids dream ability of telling you when someone has read your
  184.    mail, it can just as easily be used to tell you when someones .profile
  185.    file has been read, thus letting one know when someone else has logged
  186.    in.  Pretty good, huh? */
  187.  
  188. /* Check for mail in some files.  If the modification date of any
  189.    of the files in MAILPATH has changed since we last did a
  190.    remember_mail_dates () then mention that the user has mail.
  191.    Special hack:  If the shell variable MAIL_WARNING is on and the
  192.    mail file has been accessed since the last time we remembered, then
  193.    the message "The mail in <mailfile> has been read" is printed. */
  194.  
  195. READLINE:
  196.  
  197. This is the library that handles reading input when using an interactive
  198. shell.  The line editing commands are similar to emacs' line editing commands.
  199. You may change the default key-bindings with a ~/.inputrc file.  Various
  200. programs that use this library may add their own commands and bindings.
  201.  
  202. If you wanted to make M-C-u do universal-argument, then in your ~/.inputrc file
  203. you would put:
  204.  
  205. M-Control-u: universal-argument
  206.  
  207.   or
  208.  
  209. C-Meta-u:    universal-argument
  210.  
  211. You can use the following names for characters: RUBOUT, DEL, ESC,
  212. NEWLINE, SPACE, RETURN, LFD, TAB
  213.  
  214. You can start with a vi-like editing mode by placing
  215.  
  216.     set editing-mode vi
  217.  
  218. in your ~/.inputrc file.
  219.  
  220. You can have readline use a single line for display, scrolling the input
  221. between the two borders by placing
  222.  
  223.     set horizontal-scroll-mode On
  224.  
  225. in your ~/.inputrc file.
  226.  
  227. The following is a list of the names of the commands and the default
  228. key-strokes to get them.
  229.  
  230. COMMANDS FOR MOVING:
  231.  
  232. beginning-of-line (C-a)
  233.     Move to the start of the current line.
  234.  
  235. end-of-line    (C-e)
  236.     Move to the end of the line.
  237.  
  238. forward-char    (C-f)
  239.     Move forward a character.
  240.  
  241. backward-char    (C-b)
  242.     Move back a character.
  243.  
  244. forward-word    (M-f)
  245.     Move forward to the end of the next word.
  246.  
  247. backward-word    (M-b)
  248.     Move back to the start of this, or the previous, word.
  249.  
  250. clear-screen    (C-l)
  251.     Clear the screen leaving the current line at the top of the screen.
  252.  
  253.  
  254. COMMANDS FOR MANIPULATING THE HISTORY:
  255.  
  256. accept-li